[BD-21] Fix API docs generation and update swagger.yml#25494
[BD-21] Fix API docs generation and update swagger.yml#25494robrap merged 1 commit intoopenedx:masterfrom
Conversation
API docs generation was being blocked by missing values in the doc
settings. We wanted to update the swagger.yml to get the toggle state
("/toggles/v0/state/") endpoint in the docs.
|
Thanks for the pull request, @regisb! I've created BLENDED-649 to keep track of it in Jira. More details are on the BD-21 project page. When this pull request is ready, tag your edX technical lead. |
|
I doubt the broken test is related to the changes from this PR. This is ready for review. |
|
jenkins run py38 python |
|
Your PR has finished running tests. There were no failures. |
@robrap Pretty much, yes. The only additional thing I did was to actually run |
robrap
left a comment
There was a problem hiding this comment.
@regisb: Oh. I have no idea how the swagger docs work. So, all the changes in docs/swagger.yaml are generated. I didn't understand that. Seems like we should have a job to keep these docs up to date, but that is beyond this PR.
|
EdX Release Notice: This PR has been deployed to the staging environment in preparation for a release to production. |
|
EdX Release Notice: This PR has been deployed to the production environment. |
API docs generation was being blocked by missing values in the doc
settings. We wanted to update the swagger.yml to get the toggle state
("/toggles/v0/state/") endpoint in the docs.
cc @nedbat and @robrap.